home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / game / misc / ASokoban1_1.lha / ASokoban1.1 / ASokoban.Doc < prev    next >
Encoding:
Text File  |  1993-02-11  |  7.0 KB  |  165 lines
  1. ================================================================================
  2. ===============  NOTICE : ASOKOBAN NEEDS KICKSTART 2.0  ========================
  3. ================================================================================
  4.  
  5.  
  6.                                ASokoban v1.1
  7.  
  8.  
  9.                          © 1993 Panagiotis Christias
  10.                                              
  11.  
  12.  
  13.  
  14. GENERAL
  15. -------
  16.     ASokoban is an implementation of the UNIX game Sokoban for the Amiga. It has
  17. the original 85 levels of the UNIX game, which means that if have already played
  18. the original game, you will find ASokoban's stages familiar).
  19.  
  20.     Additionally ,  ASokoban  has a nice  user-friendly  2.0 GUI ( designed with 
  21. GadToolsBox ) , undo and  backup functions , and uses the best  existing library
  22. (ReqTools.lib) to popup all kind of requesters . It is fully multitasking, opens
  23. its window on the workbench screen, and can be iconified easily.
  24.  
  25.     Here are the instructions, for those who are not familiar with the game, but 
  26. still want to play it!
  27.  
  28.  
  29. INSTALLING ASOKOBAN
  30. -------------------
  31.     ASokoban does not need any special kind of installation.As a matter of fact,
  32. it does not need any kind of installation. You should only copy Reqtools.library
  33. into your LIBS: directory (if it isn't there already!) and you're ready.
  34.  
  35.  
  36. STARTING ASOKOBAN
  37. -----------------
  38.     You can start ASokoban either from the CLI ( ASokoban detaches itself nicely
  39. from the CLI right after being launched ) , or from the Workbench by clicking on
  40. its icon.
  41.  
  42.  
  43. HOW IS ASOKOBAN PLAYED
  44. ----------------------
  45.     You control a  strange pair of eyes  through the  maze  of each level . Your
  46. purpose is to push all the pieces of money  into the safe , which is the colored
  47. (blue) area of the maze . You can ONLY push the money ; you cannot pull it, pick
  48. it up, or anything else. There is no time limit (you sit all day trying to solve
  49. a level ) . If want a better  highscore  you can try  to solve a level  with the
  50. minimum pushes and moves. The eyes can be moved using the cursor keys (best way)
  51. or by pressing and holding down  the left mouse button . Once you have  gathered
  52. all the money packets in the safe, you can proceed to the next level.
  53.  
  54.  
  55. GADGETS
  56. -------
  57.     The playfield is surrounded by several gadgets. These are:
  58.  
  59.         New : Starts a new game at the current level (useful when you've stuck).
  60.  
  61.         Undo : Undoes the last push (not the last move!).
  62.  
  63.         Set Level : Lets you choose the level to play. Actually, it works only
  64.                     backwards, giving you the chance to replay previous levels.
  65.  
  66.         High Scores : Displays the high score list.
  67.  
  68.         About : Easy...
  69.  
  70.         Backup : "Saves" temporarily your position (before a risky step).
  71.  
  72.         Restore : Restores the previously "saved" position.
  73.  
  74.         Name : Pops up a file requester  to select the name of the file you want
  75.                to save your position and high scores for another time. Note that
  76.                your level position will also be saved in this file, allowing you
  77.                to continue the next time from the current level. By default, the
  78.                name of the file is  "ASokoban.data" . This name is  displayed in 
  79.                the string gadget on the right of the name gadget . The file name 
  80.                can also be changed by writing directly on the string gadget.
  81.  
  82.         Load : Loads the data file.
  83.  
  84.         Save : Saves the data file (happens automatically on exit).
  85.  
  86.     Extra information  is displayed on the  right of the playfield. This is the
  87. level , the total level money packets , the saved money packets , and the total
  88. moves and pushes of the eyes.
  89.  
  90.  
  91. HOW TO EXIT ASOKOBAN
  92. --------------------
  93.     You quit ASokoban either by pressing the close gadget or by pressing 'q'.
  94.  
  95.  
  96. HINTS & TIPS
  97. ------------
  98.     No hint and tips. The game isn't easy but I can guarantee that every level
  99. has its solution (maybe unique sometimes, but existing). 8^)
  100.  
  101.  
  102. BUGS
  103. ----
  104.     No known bugs. Sometimes, when using the mouse to guide the eyes, they seem
  105. to stick on the mouse pointer even when the mouse button isn't pressed. It's no
  106. real bug , it can even be useful moving the eyes quickly through the maze . For
  107. those who may like this  "feature"  a certain way to cause  it is  to press the
  108. keyboard equivalent (LEFTALT+LEFTAMIGA) of the left mouse button once. Pressing
  109. the left mouse button again brings things back to normal.
  110.  
  111.  
  112. DISTRIBUTION
  113. ------------
  114.     ASokoban is giftware , meaning that , if you like , you can send me anything
  115. (money, your programs, PD software, postcards, pizzas etc.) . It also means that
  116. it is copyright 1993 © Panagiotis Christias (me) and it is freely distributable,
  117. as  long  as  all of its files  are  included  in  their original  form  without
  118. additions , deletions , or modifications of any kind , and only a nominal fee is
  119. charged for its distribution. This software is provided "AS IS" without warranty
  120. of any kind, either expressed or implied. By using ASokoban, you agree to accept
  121. the entire risk as to the quality and performance of the program.
  122.  
  123.  
  124. HISTORY
  125. -------
  126. 1.0a    : First stable version. Distributed among my friends only for beta
  127.           testing.
  128.  
  129. 1.0b    : First official release.
  130.  
  131. 1.1     : Compiled with SAS C 6.1 using Reqtools.library 2.1. Undo bug fixed
  132.           (found it myself!). Now ASokoban saves its position  automatically
  133.           on exit ( reported by Kriton Kyrimis ) . Level 15  bug fixed , now
  134.           ASokoban  counts as saved  packets which are  in the safe from the
  135.           beginning of a level (like level 15 ) . First reported by  Carsten
  136.           Steger . When  loading a datafile  maxlevel won't decrease if max-
  137.           level of datafile is smaller than  current maxlevel . Suggested by
  138.           Sebastian Delmont.
  139.  
  140. ACKNOWLEDGEMENTS
  141. ----------------
  142.     This project was started in order  to explore and learn  the new features of
  143. KS 2.0 . Special  thanks to Commodore  for KS 2.0 ,  Nico  François for ReqTools
  144. Library, and Jan van den Baard for GadToolsBox. All of them have done a splendid
  145. job. Thanks!
  146.  
  147.  
  148. THE AUTHOR
  149. ----------
  150.     If you have any  suggestions, found any bugs, want the source of ASokoban ,
  151. or  just like the  program ,  you can contact  me via  e-mail ( preferably ) or
  152. snail-mail :
  153.                                                                          ______
  154.     e-mail: christia@theseas.ntua.gr                 "Thanks, Amiga     / / / /
  155.          or phri@leon.nrcps.ariadne-t.gr               for not being   / / / /
  156.                                                         a PC!"______  / / / /
  157.     address:  Panagiotis Christias                            \ \ \ \/ / / /
  158.               Argirokastrou 40, Papagou 15669                  \ \ \/\/ / /
  159.               Athens, GREECE                                    \ \/\/\/ /
  160.                                                                  \/\/\/\/
  161. --------------------------------------------------------------------------------
  162. Notice : If you'ld like to see in the future a level editor for ASokoban let me
  163.          know.
  164. ================================================================================
  165.